home *** CD-ROM | disk | FTP | other *** search
/ c't freeware shareware 1997 / CT_SW_97.ISO / pc / software / entwickl / macos / ingwdef.hqx / IngisWDEF 1.2 ƒ / IngisWDEF 1.2 docs < prev    next >
Text File  |  1996-08-25  |  4KB  |  74 lines

  1.  
  2. *** Ingis WDEF ***
  3.  
  4. Ingemar Ragnemalm's Window Definition package, version 1.2
  5.  
  6. ______
  7.  
  8.  
  9. Ingis WDEF is sample code to a WDEF, but actually, it is slightly more than that. It is a package that is designed to make WDEF design easier. The approach is to provide a kind of skeleton, where the reuseable code is separated from your custom code. The reuseable code calls the custom code through a set of predefined procedures.
  10.  
  11. IngisWDEF was used for creating the hexagonal window in Hexmines 2.0, as well as the round window in the Pascal version of "NewWatch" (a source code demo of an analog clock).
  12.  
  13. The package consists of source code files, projects and demo programs:
  14.  
  15. • Core files: IngisWDEF.p, CustomStubs.p (Empty) and IngisWDEFUtils.p.
  16.      - IngisWDEF.p: Main unit. Most reuseable code is here. It calls all custom routines as appropriate.
  17.      - CustomStubs.p (Empty): This is the empty stubs file, with a bunch of empty procedures for you to fill in as you like them.
  18.      - IngisWDEFUtils.p: A set of procedures that you might want to call from the custom routines. Includes check for ColorQD, some standard colors and some standard items (close, zoom and grow icons).
  19.  
  20. • Demos: SimpleCustomStubs.p, VariantCustomStubs.p and CustomStubsCirc.p. These are copies of CustomStubs.p with a few procedures filled in, in order to make each a complete, working - though simple - WDEF.
  21.      - SimpleCustomStubs.p: Implements a rounded-rect window with a drag bar and close box.
  22.      - VariantCustomStubs.p: Implements a window with drag, with a shape that is determined from the varCode.
  23.      - CustomStubsCirc.p: Implements a circular window.
  24.  
  25. For the demos, there are project files, the skeleton program Skel 3.0iw for trying the WDEFs in, and copies of the latter with WDEFs installed (Skel/Simple, Skel/Circ…).
  26.  
  27. NOTE: Skel 3.0iw does NOT include any WDEF. It is used as resource file for the demos, not intended to run as it is. If you run it, it will just show a standard window.
  28.  
  29.  
  30. VERSION 1.1 CHANGES:
  31.  
  32. Version 1.1 supports not only Think Pascal but also Metrowerks Pascal (68k only). To do this, I had to make the following changes:
  33. • Add project files for MWP for each demo.
  34. • The "CustomStubs" files for the demo are all named "CustomStubs.p". This is less informative and gives a risk to mix up files. However,  it was necessary since Metrowerks Pascal demands that file names and unit names match.
  35. • A bunch of conditional compilation switches were added. The demo code gets longer by this, but you can always delete the parts that don't apply to your development system.
  36.  
  37. Another change is that Skel has slightly more memory. The "variant" demo in 1.0 behaved strangely on PowerMacs with VM off, due to lack of memory. This was not a problem with IngisWDEF, just memory shortage.
  38.  
  39. VERSION 1.2 CHANGES:
  40.  
  41. Updated for CodeWarrior 9.
  42.  
  43. _____
  44.  
  45. Limitations:
  46. ===========
  47.  
  48. The current version of IngisWDEF does not have a "deviceloop", which means that it may not produce perfect results when its window are placed across screen borders.
  49.  
  50. Legal terms:
  51. ===========
  52.  
  53. IngisWDEF is © 1994-1996 by Ingemar Ragnemalm. It may be used for no charge if credits are given in the documentation of the end product.
  54.  
  55. Acknowledgements:
  56. ==================
  57.  
  58. The following sources have been of great help while developing IngisWDEF:
  59.  
  60. Fwin, hexagonal WDEF by Folke Söderström, most important
  61. CircleWDEF by Richard Koch, elegant, small source with most features
  62. Windoid by Gregory H. Dow, only Pascal WDEF source I found
  63. InfinityWindoid by Troy Gaul, only color demo I found
  64.  
  65.  
  66. Author's address:
  67.  
  68. E-mail: ingemar@lysator.liu.se
  69.  
  70. Ingemar Ragnemalm
  71. Plöjaregatan 73
  72. S-58330 Linköping
  73. SWEDEN
  74.